home *** CD-ROM | disk | FTP | other *** search
/ The Utilities Experience / The Utilities Experience - Volume 1.iso / software / graphics / n-z / playkiss / docs / kiss.doc next >
Text File  |  1995-12-21  |  10KB  |  335 lines
  1.  
  2.                            -Play KiSS 0.88-
  3.  
  4.   A  program  designed  to  play  KISS  data sets on an Amiga computer
  5. equiped  with OS 3.0.  The AGA chip set (or equiv) is required to play
  6. sets with more than 32 colors.
  7.  
  8.   Usage  is simple, and not much documentation should be required...
  9.  
  10. A few notes:
  11.  
  12. To  run  from CLI, you can specify the kiss set as the first argument.
  13.  
  14. To  run  from  WB,  you  can  shift-double-click  on a kiss .CNF file,
  15. provided  it  has  an  icon.   Play KiSS supports default tools inside
  16. project  icons  this way.  So you can add project icons to .CNF files.
  17. Maybe a whatis/dopus class??  hint hint.
  18.  
  19. Other   tooltypes   and   arguments  are  supported  to  set  up  your
  20. environment.   These  are listed in the icon, and from CLI by using ?.
  21. They  should  be  self  explanatory once you've used the program a few
  22. times.
  23.  
  24.  
  25. Play  KiSS  handles  low-memory situations VERY BADLY.  That's why the
  26. available  memory  is  listed everywhere.  Keep an eye on this.  Don't
  27. use the buffered dragging if you are running short.  Delete background
  28. .CEL's  if  need  be.  And remember that Play KiSS loads *ALL* CELs at
  29. once, even if there are not displayed!
  30.  
  31.  
  32.  
  33.  
  34. "Play  KiSS"  was  meant  to overcome a few of AmiKiss's shortcomings.
  35. But it's not perfect.  Here is a point by point comparison:
  36.  
  37.                         Play KiSS               AmiKiss
  38.  
  39. 224c compat?            Yes                     Yes
  40. Kiss/GS compat?         Yes, upto GS4           No
  41. Maximum colors          256                     16
  42. Maximum play area       Limited by hardware     640x400
  43. Saves set coords?       Yes                     No
  44.  
  45. Movement type           ClipBlit, bad flicker   GELS, little flicker
  46. Layered dragging?       Yes, bad flicker        No
  47.  
  48. Memory handling         BAD Will crash          Good. Informs user
  49. Dynamic CEL loading?    Caches in FAST          Caches from disk
  50.  
  51. Minimum system          OS 3.0                  OS 2.1 (1.3?)
  52.  
  53. I've  talked  to the author of AmiKiss briefly, and he stated he would
  54. be  able  to add many of the missing features, (save .cnf mainly), but
  55. would  be unable to add 256 color support.  This was when I decided to
  56. put my offering out.  I don't want to start some competition.  I wrote
  57. this  program FOR MYSELF, and am offering to others freely.  I did not
  58. spend  much  time  on  it  (it  shows in spots), and therefore I'm not
  59. asking for anything in return.
  60.  
  61. btw,  if  you want to pass out cash, give some to the original AmiKiss
  62. author.  He's the one that opened my eyes to the kiss phenom.
  63.  
  64.  
  65.  
  66.  
  67.                            -Edit CEL 0.78-
  68.  
  69. A simple IFF->CEL program with a GUI interface.
  70.   NOT TESTED much.
  71.  
  72. Usage should be self explanatory.
  73.  
  74. It's opened to future expansion, as I need it.
  75.  
  76.  
  77.  
  78.                          -KISSUTILS archive-
  79.  
  80. This  entire  archive  is  being claimed PUBLIC DOMAIN by it's author,
  81. Chad  Randall.  As far as the author knows, everything included within
  82. this  archive  is  original material, and therefore under his control.
  83. If  this is not the case, then remember that any prior copyrights have
  84. precedence.
  85.  
  86. files in the archive:
  87.  
  88. bin/ppmtocel
  89. bin/celtoppm
  90. bin/maptokcf
  91. bin/kcftomap
  92. bin/makemap
  93. src/ppmtocel.e
  94. src/celtoppm.e
  95. src/maptokcf.e
  96. src/kcftomap.e
  97. src/makemap.e
  98. this doc file
  99.  
  100.  
  101. Required programs:
  102.  
  103. netppm from Aminet:gfx/pbm  : Please read appropriate .readme's.
  104. "pcxtoppm" - Converts "PaperDoll" pcx files to ppms.
  105. "ppmtomap" - Converts a .ppm into a .map file.
  106. "quantppm" - Reduces the amount of colors, and optionally remaps.
  107. "ilbmtoppm"- Converts IFFs into ppms
  108. "ppmtoilbm"- Convers ppms into IFFS
  109.  
  110. spat and list from your S: and C: directories.
  111.  
  112. AmiKiss    - Displays kiss data files.
  113. You should already have this, but if not, it's available on:
  114. venice.tcp.com:pub/anime-manga/incoming/AmiKiss11.lha
  115. ftp.netcom.com:pub/mughi/Kiss/program/AmiKiss11.lha
  116. ftp.funet.fi:unknown directory (?)
  117.  
  118. I believe it was removed from Aminet due to nudity.  It's not in the
  119. INDEX, although I originally got it from there.
  120.  
  121.  
  122.  
  123. Some basic terminology.
  124.  
  125. KISS-  A  japanese  set  of  programs  to play paper doll with images,
  126. mainly  anime  girls,  although  not  limited  to this.  Graphics were
  127. originally limited to 16 colors, but you will run into newer 256 color
  128. versions.   AmiKiss is currently limited to 16.  If it refuses to load
  129. data, saying the images are over 1000 pixels wide, then it's the wrong
  130. type of data.
  131.  
  132. PAPERDOLL- An australian program (part of an unreleased game), that is
  133. similar  to  KISS, but not as powerful.  The images are in PCX format,
  134. and  can be easily converted to cells.  A sample session is at the end
  135. of this .doc.
  136.  
  137. CEL-  An  image or part of a bigger image.  This is the main file type
  138. of KISS datas.
  139.  
  140. KCF-  A  palette  file  consisting  of 10 seperate "sets" of palettes.
  141. Usually only the first one is usable.
  142.  
  143. CNF-  A file describing what CEL files, and which KCF file is used for
  144. the  environment.   The  data  format  is  in  text, and can be easily
  145. edited.   See  the  AmiKiss.guide file, or "sampkiss.cnf" file for the
  146. layout.
  147.  
  148. PPM-  A  portable  pixmap file.  There are two sub-types of a .ppm, P3
  149. and  P6.   P3  is  in  a text-only format, whereas P6's are in binary.
  150. Only  type  P6's  are supported by my KissUtils.  You should use these
  151. anyways, as they are usually 1/2-1/3 in size comapared to P3's.
  152.  
  153. MAP- Also a portable pixmap file, but used to describe a palette.  The
  154. bitmap  is  as  wide as the number of colors, and only one pixel high.
  155. Each pixel is a palette entry.
  156.  
  157. 218  or 224c- The older KISS formats.  Only 16 colors, and 12 bits per
  158. color are supported.  Play area was limited to 448x320 and 640x400.
  159.  
  160. KISS/GS-  A  newer  standard  KISS  format  datatype,  also  known  as
  161. KISS/GS1,  KISS/GS2,  KISS/GS3,  KISS/GS4,  or just GS.  Lower numbers
  162. denote   smaller  requirements,  mainly  based  on  limited  VGA  card
  163. resolutions.
  164.  
  165.  
  166.  
  167.  
  168. ppmtocel
  169.  
  170. Usage: ppmtocel sourcefile [destinationfile] mapfile [OLD]
  171.  
  172. Examples:
  173.   ppmtocel image.ppm MAP=image.map
  174.   ppmtocel image.ppm image.cel image.map
  175.   ppmtocel image.ppm image.cel MAP image.map
  176.  
  177. Function:
  178.  
  179. Converts  a  pnm  type  6  (P6)  into  a  .CEL, using a .map file as a
  180. reference  to  recolor.   Both  type  "KiSS"  and older 224c types are
  181. supported.
  182.  
  183. If  the  destination file is left out, or is specified as "", then the
  184. sourcefile  name  will  be used, minus the ".ppm", and a ".CEL" tacked
  185. on.
  186.  
  187. Notes:
  188.  
  189. If  ppmtocel  complains  about  too  many  colors,  use "ppmquant -map
  190. image.map  image.ppm  >image2.ppm" to reduce the amount of colors, and
  191. match them to the .map file.
  192.  
  193. Use the "OLD" switch to save a 224c type file.  These are required for
  194. the current release of AmiKiss.
  195.  
  196. Known Bugs:
  197.     The  source  file must be a standard P6 type, support for P 1-5 is
  198. not implemented
  199.     The .map file must have at least 10 colors, and no more than 16.
  200.  
  201.  
  202.  
  203.  
  204. celtoppm
  205.  
  206. Usage celtoppm sourcefile [destinationfile] kcffile
  207.  
  208. Examples:
  209.   celtoppm image.cel KCF=image.kcf
  210.   celtoppm image.cel image.map image.kcf
  211.   celtoppm image.cel image.map KCF image.kcf
  212.  
  213. Function:
  214.  
  215. Converts  a  .cel  file  into  a type P6 .ppm file.  The .kcf supplies
  216. vital color information, and is required.
  217.  
  218. If  the  destination file is left out, or is specified as "", then the
  219. sourcefile  name  will  be used, minus the ".CEL", and a ".ppm" tacked
  220. on.
  221.  
  222. Known Bugs:
  223. Only the first palette in the .KCF file is used.
  224.  
  225. Only supports the older 224c types.
  226.  
  227.  
  228.  
  229. maptokcf
  230.  
  231. Usage maptokcf sourcefile destinationfile
  232.  
  233. Examples:
  234.   maptokcf image.map image.kcf
  235.  
  236. Function:
  237.  
  238. Converts a .map (type P6), into a .KCF file.
  239.  
  240. Known Bugs:
  241.  
  242. Only  one  .kcf  palette is supported, and is copied into the upper 9,
  243. giving 10 duplicate palette entries.
  244.  
  245. The .map file must contain at least 10 entries, and no more than 99.
  246.  
  247. The  height  must  be at least 1, and no more than 9.  (A standard map
  248. file is always 1 pixel high!)
  249.  
  250. Only supports the older 224c types.
  251.  
  252.  
  253.  
  254. kcftomap
  255.  
  256. Usage kcftomap sourcefile destinationfile
  257.  
  258. Examples:
  259.   kcftomap image.kcf image.map
  260.  
  261. Function:
  262.  
  263. Converts a .kcf file into a standard type P6 .map file.
  264.  
  265. Known Bugs:
  266.  
  267. Only the first palette is used.
  268.  
  269. Only supports the older 224c types.
  270.  
  271.  
  272.  
  273. makemap
  274.  
  275. Usage:
  276.   makemap im#?.ppm izjus1?.ppm image.map
  277.     makemap image#?.ppm image.map
  278.     makemap #? image.map
  279.     makemap a#? b#? c#? d#? e#? f#? image.map
  280.  
  281. Function:
  282.  
  283. Scans .ppm files, collecting the first 16 unique colors.
  284.  
  285. Standard AmigaDOS wildcards, and multiple source patterns are supported.
  286.  
  287. Known Bugs:
  288.  
  289. To  make  sure  the first palette entry is the transparent background,
  290. you  may  wish  to  specify  a file you know to have that color at the
  291. upper-left pixel!
  292.  
  293. Only  type P6 ppm files are supported.  Therefore, it is impossible to
  294. edit your own using a text editor.
  295.  
  296. Only supports the older 224c types.
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.              Converting a PaperDoll set into a Kiss one.
  304.  
  305. It seems alot of people like PaperDoll better than Kiss, as many Kiss
  306. sets have been converted to PaperDoll format.  As far as I can tell,
  307. PaperDoll is not nearly as powerful as Kiss, so why people do use it,
  308. I don't know.
  309.  
  310. But there are a few unique paperdoll sets already.  I originaly wrote
  311. these utils to do just this, and it's been more than successful.
  312.  
  313. You should be proficient in the use of a shell, and have at least 4+
  314. megs of available harddrive space.
  315.  
  316. Below, replace "name" with the name of the paperdoll set.  All
  317. paperdoll sets use one base name, so it's not hard to figure out.
  318.  
  319.  
  320. unarc (UnARJ) the paperdoll set into it's OWN directory.
  321. Use 'spat pcx2ppmmulti name.F#?'
  322. Then 'makemap name.F#?.ppm name.map'
  323.      'list name.F#?.ppm LFORMAT "ppmtocel %s MAP=name.map" >ram:exme'
  324.      'Execute ram:exme'
  325.  
  326. If for anyreason, a ppm file comes out with more than the base 16
  327. colors, you'll need to remap it.  Use 'ppmquant' as detailed
  328. previously.
  329.  
  330. You'll need to write a 'name.CNF' file.  Just edit the 'name.TXT'
  331. file, flipping the order of which the names appear!  Also, add a set
  332. line to place all the cels out of the upper-left corner.  If you're
  333. not sure how to do this, take a look at some sample .CNF files.
  334.  
  335.